RESTful Web Service তৈরি করা বেশ সহজ এবং এটি HTTP প্রোটোকল ব্যবহার করে ডেটা আদান-প্রদান করে। Apache CXF এর সাহায্যে আপনি সহজেই RESTful ওয়েব সার্ভিস তৈরি করতে পারবেন। এখানে, আমরা ধাপে ধাপে দেখাবো কিভাবে একটি সাধারণ RESTful ওয়েব সার্ভিস তৈরি করতে হয়।

ধাপ 1: Maven প্রজেক্ট তৈরি করা

প্রথমে, একটি নতুন Maven প্রজেক্ট তৈরি করুন। আপনি Maven এর archetype:generate কমান্ড ব্যবহার করতে পারেন অথবা আপনার পছন্দসই IDE যেমন Eclipse বা IntelliJ ব্যবহার করতে পারেন।

1.1 Maven প্রজেক্ট তৈরি করা (Command line)

Maven কমান্ড ব্যবহার করে একটি নতুন প্রজেক্ট তৈরি করুন:

mvn archetype:generate -DgroupId=com.example.rest -DartifactId=rest-hello-world -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

এটি একটি নতুন Maven প্রজেক্ট তৈরি করবে। এবার, এই প্রজেক্টের pom.xml ফাইলে Apache CXF এবং RESTful ওয়েব সার্ভিসের জন্য প্রয়োজনীয় ডিপেনডেন্সি যোগ করুন।

ধাপ 2: pom.xml ফাইল কনফিগারেশন

RESTful ওয়েব সার্ভিস তৈরি করার জন্য আপনাকে pom.xml ফাইলে Apache CXF এর RESTful ডিপেনডেন্সি যোগ করতে হবে। নিচে একটি উদাহরণ দেওয়া হল:

<dependencies>
    <!-- Apache CXF Dependency for JAX-RS (RESTful Web Services) -->
    <dependency>
        <groupId>org.apache.cxf</groupId>
        <artifactId>cxf-rt-frontend-jaxrs</artifactId>
        <version>3.5.0</version>
    </dependency>

    <!-- JAXB Dependency for XML binding (Optional) -->
    <dependency>
        <groupId>javax.xml.bind</groupId>
        <artifactId>jaxb-api</artifactId>
        <version>2.3.1</version>
    </dependency>

    <!-- Apache CXF Dependency for Logging -->
    <dependency>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-api</artifactId>
        <version>2.13.3</version>
    </dependency>
</dependencies>

<build>
    <plugins>
        <!-- Maven Compiler Plugin -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
            </configuration>
        </plugin>

        <!-- Apache CXF Codegen Plugin (for automatic code generation) -->
        <plugin>
            <groupId>org.apache.cxf</groupId>
            <artifactId>cxf-codegen-plugin</artifactId>
            <version>3.5.0</version>
            <executions>
                <execution>
                    <goals>
                        <goal>wsdl2java</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

এখানে:

• cxf-rt-frontend-jaxrs: RESTful ওয়েব সার্ভিসের জন্য প্রয়োজনীয় লাইব্রেরি।
• jaxb-api: XML এবং JSON এর সাথে কাজ করার জন্য (যদি ডেটা সিরিয়ালাইজ করতে চান)।
• log4j-api: লগিং ব্যবস্থার জন্য।

ধাপ 3: RESTful Web Service ক্লাস তৈরি করা

এখন, আপনি আপনার RESTful ওয়েব সার্ভিস ক্লাস তৈরি করতে পারেন। এটি একটি সাধারণ "Hello World" সার্ভিস হবে, যা ইনপুট হিসেবে একটি নাম গ্রহণ করে এবং একটি স্বাগত বার্তা ফেরত দিবে।

3.1 RESTful Web Service ক্লাস

HelloWorldService.java নামে একটি ক্লাস তৈরি করুন:

package com.example.rest;

import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.QueryParam;

@Path("/hello")  // Base URL path
public class HelloWorldService {

    @GET
    @Path("/greet")  // Subpath for specific method
    public String sayHello(@QueryParam("name") String name) {
        if (name == null || name.isEmpty()) {
            return "Hello, World!";
        }
        return "Hello, " + name + "!";
    }
}

এটি একটি GET রিকোয়েস্ট হ্যান্ডলার, যা /hello/greet URL পাথের মাধ্যমে ওয়েব সার্ভিস কল করবে এবং name প্যারামিটার গ্রহণ করবে।

ধাপ 4: RESTful Web Service সার্ভার কনফিগারেশন

এখন, আপনাকে ওয়েব সার্ভিস চালু করার জন্য একটি সার্ভার কনফিগারেশন তৈরি করতে হবে। Apache CXF JAX-RS সার্ভার ফ্যাক্টরি ব্যবহার করে সহজে সার্ভিস চালু করা যায়।

4.1 Server.java (সার্ভার কনফিগারেশন)

package com.example.rest;

import org.apache.cxf.jaxrs.JAXRSServerFactoryBean;

public class Server {

    public static void main(String[] args) {
        // Create the JAX-RS server factory
        JAXRSServerFactoryBean factory = new JAXRSServerFactoryBean();
        
        // Set the service class
        factory.setServiceClass(HelloWorldService.class);
        
        // Set the base address (URL) where the service will be hosted
        factory.setAddress("http://localhost:8080/");
        
        // Create and start the server
        factory.create();
        
        System.out.println("Server started at http://localhost:8080/hello/greet");
    }
}

এটি সার্ভিসের হোস্টিং এর জন্য একটি ফ্যাক্টরি ক্লাস তৈরি করে এবং HelloWorldService ক্লাসকে সেট করে। সার্ভিসটি http://localhost:8080/hello/greet URL পাথে চলে আসবে।

ধাপ 5: সার্ভিস চালু করা

এখন, Maven ব্যবহার করে আপনার প্রজেক্ট কম্পাইল ও চালু করুন। নিম্নলিখিত কমান্ডগুলি ব্যবহার করে এটি করতে পারেন:

mvn clean install
mvn exec:java -Dexec.mainClass=com.example.rest.Server

এটি সার্ভিসটি চালু করবে এবং আপনার ব্রাউজারে গিয়ে http://localhost:8080/hello/greet?name=John এই URL এ GET রিকোয়েস্ট পাঠান।

ধাপ 6: ওয়েব সার্ভিস টেস্ট করা

ব্রাউজারে বা Postman এর মতো টুল ব্যবহার করে আপনি এই ওয়েব সার্ভিস টেস্ট করতে পারেন। যদি আপনি name=John প্যারামিটার পাঠান, তবে আপনি নিচের আউটপুট পাবেন:

Hello, John!

আর যদি প্যারামিটার না পাঠান, তাহলে আউটপুট হবে:

Hello, World!

সারাংশ

এই প্রক্রিয়াটি ব্যবহার করে আপনি Apache CXF এর মাধ্যমে একটি RESTful ওয়েব সার্ভিস তৈরি করেছেন। এটি একটি সাধারণ GET রিকোয়েস্ট হ্যান্ডলারের মাধ্যমে ডেটা ফেরত দেয়। আপনি এই সার্ভিসটিকে বিভিন্ন ক্লায়েন্ট অ্যাপ্লিকেশন থেকে ব্যবহার করতে পারেন।